Skip to content

T-313 - Garantir a retenção do registro de auditoria - #420

Merged
pedro-fs-garcia merged 3 commits into
developfrom
feature/t-313-retencao-registro-auditoria
Nov 12, 2026
Merged

pedro-fs-garcia merged 3 commits into
developfrom
feature/t-313-retencao-registro-auditoria

Conversation

@Madhs31

@Madhs31 Madhs31 commented Nov 11, 2026

Copy link
Copy Markdown
Contributor

Objetivo

Garantir e comprovar que uma falha isolada na gravação da trilha não interrompe a simulação e que o registro é recuperado sem duplicação.

Alterações

  • Registra na DEC-096 a decisão da P.O. de manter a retenção pela fila durável com reentrega.
  • Atualiza a documentação da arquitetura.
  • Adiciona o contador de consumo de no-concluido, distinguindo gravação, duplicata, descarte e falha.
  • Registra falhas com correlação por job e nó, sem expor a conclusão ou a exceção original do banco.
  • Preserva os descartes de validação e a reentrega em falhas de persistência.

Validação

  • make check aprovado: 1575 testes, zero falhas, zero erros e 6 pulados.
  • Teste com Postgres e RabbitMQ reais revoga temporariamente o INSERT em trilhas_auditoria.
  • Confirma que o job chega à decisão do usuário durante a falha.
  • Após restaurar a permissão, confirma uma única linha e a deduplicação da reentrega.
  • Logs serializados validados contra o schema.
  • Contador conferido no MeterRegistry e em /metrics.
  • git diff --cached --check aprovado.

Os seis testes pulados são cenários opcionais, incluindo a transcrição real e fluxos completos externos.

Limite da garantia

A garantia cobre falha isolada na escrita da trilha. Uma indisponibilidade total do Postgres ou do RabbitMQ está fora do escopo.

Registra na DEC-096 a retenção pela fila confirmada pela P.O. e atualiza a arquitetura.

Instrumenta o consumo de no-concluido com os resultados gravado, duplicado, descartado e falha, mantendo os erros de persistência sanitizados e a reentrega.

Testa a continuidade da simulação durante a falha da trilha, a recuperação sem duplicação, os logs e a exposição das métricas.

Validação: make check aprovado com 1575 testes, zero falhas, zero erros e 6 pulados.

Review: auto
pedro-fs-garcia and others added 2 commits November 12, 2026 07:23
O log "falha na gravação da trilha" passa a trazer extra.classe_falha com o
nome simples da classe da exceção, para distinguir uma referência inexistente
de um banco indisponível sem expor a mensagem nem a causa. O
NoConcluidoDto da T-301 ganhou o campo resultado_id, e o teste de
observabilidade passa o argumento a mais.

Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
@pedro-fs-garcia
pedro-fs-garcia merged commit 5291871 into develop Nov 12, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants